home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
BBS Toolkit
/
BBS Toolkit.iso
/
wildcat
/
wca3xv2.zip
/
WCA3X.DOC
< prev
next >
Wrap
Text File
|
1992-10-03
|
11KB
|
263 lines
D O C U M E N T A T I O N F O R
Wildcat! 3 Analyzer V2.0
for Caller Statistics
========================
by Larry E. Hardeman
Hardeman's Christian BBS
1734 Fairview Drive
Moody, AL 35004
Voice:(205)640-7581
BBS:(205)640-6436
24hrs 1200/2400
==============================================================================
This program is Shareware and may be distributed freely to friends and other
BBS's. You may use this software for a evaluation period of 30 days. If after
the end of 30 days and you want to continue using it, you are expected to send
a $10.00 registration fee to the above address. At that time, I will make
available a special ID file and upload it to your board. The ID file will be
able to be used in all future releases of this program. For more details, see
the order form file ORDER.FRM for placing orders. -Thank you.
==============================================================================
WC3 Analyzer - Page 1
INTRODUCTION:
=============
I am not held resposible for misuse of this program and damage of any data
files on your system. You are required to have a knowledge of setting up
batch files and the use of the Wildcat! configuration program MAKEWILD.EXE
to properly maintain your system. Read all instructions carefully and you
should not have any problems with the installation.
Wildcat! 3 Analyzer is a program that compiles the caller stats for Wildcat!
Version 3.x Bulletin Boards to BULLX.BBS files. The bulletins use the special
@COLOR@ color codes for Wildcat BBS's, thus eliminating the need for an ASCII
file and and ANSI file for each bulletin.
Six bulletins are made, Last Ten Callers, Top Callers, Top Message Writers,
Top Uploaders, Top Downloaders and Hours of Board Use. Information is
retreived from the DOOR.SYS file when a call is terminated via use of the
POSTCALL.BAT or POSTCALL.RUN batch files. For multi-node systems, each work
directory (ie, c:\wc30\wcwork\node1....node5) is required to have it's own
configuration file and POSTCALL.BAT procedure and the program is to be
launched from that directory.
Below are a listing of the files included needed to be a complete package
and should be intact on all distribution copies of this software.
WCA3X.EXE The program.
WCA3X.CFG A sample configuration program.
WCA3X.DOC This documentation.
POSTCALL.RUN A sample batch for use in the work directory.
WCA3X.LST A list of names to exclude from bulletins.
1TO2CNGS.TXT Changes from v1.0 to v2.0
UPGRADING FROM VERSION 1.0:
===========================
Very little needs to be done to make the change over from version 1.0 to this
version.
1. First thing, copy WCA3X.EXE, WCA3X.DOC, WCA3X.LST and 1TO2CHGS.TXT
to your WILDCAT! work directory (most likely C:\WC30).
2. Modify your existing WCA3X.LST to match the one in the following
Installation procedures.
3. Make the WCA3X.LST file and place it in the Wildcat WORK directory.
The file must have at least one name in it, even if it is a dummy
name.
4. Run the WCA3X.EXE program from a NODE directory with the parameter
/rt as outlined in the Final Procedures on page 4.
This should be all you need to do. I do suggest that you do take the time to
read all of this document.
INSTALLATION:
=============
Installation is quite simple and a single line system should be up and
running in a matter of minutes. As a matter of fact, it will probably take
you longer to read all this than actually set up the software.
First step, make sure you have all the files listed above. We will now edit
the configuration file using your favorite line editor (I like TED). Below
is how the configuration file (WCA3X.CFG) is layed out. This file(s) is to be
placed in each node directory for multi-node systems so the program may know
where to look for the DOOR.SYS file.
NO ;Use Local Logons
c:\wc30 ;Home Directory
c:\wc30\wcwork\node1 ;Node Directory
c:\wc30\bull\bull7.bbs ;Top 10 Callers
c:\wc30\bull\bull8.bbs ;Top 10 Messagers
c:\wc30\bull\bull9.bbs ;Top 10 Uploaders
c:\wc30\bull\bull10.bbs ;Top 10 Downloaders
c:\wc30\bull\bull6.bbs ;Last 10 Callers
c:\wc30\bull\bull11.bbs ;Hours of use
Messages Started 02-02-92 Files Started 05-27-91 ;Remark Line 1
Above callers have called since 02-12-92. ;Remark Line 2
When you modify the above file, make sure you don't put any ";" in a line
other than the ones noted. These are used to represent a remark. There must
be 11 lines as shown in the WCA3X.CFG file and this file needs to be copied
to each node work directory. (ie C:\WC30\WCWORK\NODEx)
WC3 Analyzer - Page 2
Use Local Logons If this is set to NO, all local logons will be ignored
and no bulletins will be updated.
Home Directory This is the location of the WCA3X.EXE and WCA3X.ID (if you
are registered) and it should be the same directory that
your Wildcat! 3 program resides.
Work Directory The working directory for each specific node. This is
where Wildcat! places the DOOR.SYS file for a drop to DOS
or DOS hooks. You should place a specific WCA3X.CFG file
in each work directory along with the proper POSTCALL.RUN
batch file (see the Wildcat! users manual for details).
Bulletin Directory This is the directory where your bulletins are located.
Next 6 Lines These are rather obvious. You need to place on each line,
in order, as shown above the bulletin names of bulletins
to be used. If you choose not to use a specific bulletin,
just give it a dummy name to prevent it from being read
by Wildcat!. ALL LINES MUST BE USED!!!
Remark 1 & 2 The last 2 lines are remark lines that will appear at the
bottom of each bulletin and can be up to 73 characters in
length. I use these to let folks know what dates each
statistic category was originated. You may place anything
you wish here, or simply place a carriage return for no
remarks.
WC3 Analyzer - Page 3
The WCA3X.LST file
==================
This file contains names that you don't want bulletins generated for. It will
only tabulate the call in the Hours of Use bulletin, unless it is a local
call. The file can contain up to 100 lines, on each line there MUST be a
users name. The primary use of this file is to keep from tabulating the
Sysop and NetMail users in the bulletins. It is up to you whether or not
you use it, but it must be located in the WORK DIRECTORY and contain at least
one name. Here is a sample file:
Larry Hardeman
Hc Bbs
Pooh Bbs
Cab Bbs
Family Bbs
POSTCALL.BAT (or POSTCALL.RUN
=============================
Now for the oh so confusing POSCTALL.BAT or POSTCALL.RUN batch file. There
are 2 methods of using batch files for DOS Hooks. You are required to have
a knowledge of these, and each depends on whether you allow a terminated on
Doors and Menu Hooks in the MAKEWILD.EXE program. I suggest you answer "N"
to this prompt and let Wildcat! shell to another copy of the command.com
file. The examples I will give are for this set-up, and will be using the
POSTCALL.RUN batch instead of the POSTCALL.BAT which is used if you have
answered "Y" to the terminated on Doors and Menu Hooks.
Below you will see a simple POSTCALL.RUN batch file that must be made up and
placed in each work directory for each node. Notice that there is no line
calling Wildcat! back, this is because we shelled instead of terminated.
@echo off ;Turn off screen echos
cls ;Clear the screen
c:\wc30\wca3x ;Run WCA3X which is located in the HOME DIRECTORY.
This is the exact POSTCALL.RUN file that I use and it works fine and you
should have no trouble using it.
WC Analyzer - Page 4
FINAL PROCEDURE:
================
To set the number of Calls per hours used in the Hours of Use bulletin, you
need to run the program with the /rt parameter from your WC NODE Directory
that contains the WCA3X.CFG file. This will make a file called WCATIMES.TXT
which will contain 8 lines of zeros and the last line will be the date and
time the /rt parameter was run. The program can be run periodically with the
/rt parameter to reset the calls if you like. Maybe like once a week as an
event. It's up to you.
The first time WCA3X is run with NO PARAMETERS, 5 more files will be created,
WC????.TXT.
OVERVIEW:
=========
Since this program does not scan the user database, it only starts compiling
data as calls are terminated. Thus, only callers calling since installing
this software will be recorded.
There are 6 files which are generated by WCA3X that should not be deleted.
They are located in the Home Directory (WCALST10.TXT, WCACALLS.TXT,
WCAMSGS.TXT, WCAULS.TXT, WCADLS.TXT and WCATIMES.TXT) and are the sort files
for each bulletin. Deleting any of these files will cause the program to
start over on collecting data for the top users in each bulletin.
If you do want to start it all over again, simply delete them and it will
begin the process of collecting callers all over.
UPDATES:
========
Updates will be made available through my bulletin board and the WILDCAT
support BBS. Registration will be good for all minor updates. As we have
already learned in time past, if Wildcat! goes thru a major change, this
program may or may not work, but as long as they keep using the DOOR.SYS
and means of shelling to DOS on a callers termination, I don't see any
problems.
CLOSING:
========
If you have any questions, please call the bulletin board on the front
cover of this documentation and leave me a comment. Any suggestions to
improve this software are encouraged.
Wildcat! is a registered trademark of Mustang Software, Inc.